Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

https://travis-ci.org/GNS3/gns3-server.svg?branch=master https://img.shields.io/pypi/v/gns3-server.svg

This is the GNS3 server repository.

The GNS3 server manages emulators such as Dynamips, VirtualBox or Qemu/KVM. Clients like the GNS3 GUI controls the server using a HTTP REST API.

You will need the GNS3 GUI (gns3-gui repository) to control the server.

Branches

master

master is the next stable release, you can test it in your day to day activities. Bug fixes or small improvements pull requests go here.

unstable

Never use this branch for production. Pull requests for major new features go here.

Linux

GNS3 is perhaps packaged for your distribution:

Linux (Debian based)

The following instructions have been tested with Ubuntu and Mint. You must be connected to the Internet in order to install the dependencies.

Dependencies:

  • Python 3.4 or above

  • aiohttp

  • setuptools

  • netifaces

  • jsonschema

The following commands will install some of these dependencies:

sudo apt-get install python3-setuptools

Finally these commands will install the server as well as the rest of the dependencies:

cd gns3-server-master
sudo python3 setup.py install
gns3server

To run tests use:

py.test -v

Run as daemon (Unix only)

You will found init sample script for various systems inside the init directory.

Usefull options:

  • –daemon: start process as a daemon

  • –log logfile: store output in a logfile

  • –pid pidfile: store the pid of the running process in a file and prevent double execution

All the init script require the creation of a GNS3 user. You can change it to another user.

sudo adduser gns3

upstart

For ubuntu < 15.04

You need to copy init/gns3.conf.upstart to /etc/init/gns3.conf

sudo chown root /etc/init/gns3.conf
sudo service gns3 start

systemd

You need to copy init/gns3.service.systemd to /lib/systemd/system/gns3.service

sudo chown root /lib/systemd/system/gns3.service
sudo systemctl start gns3

Windows

Please use our all-in-one installer to install the stable build.

If you install via source you need to first install:

Then you can call

python setup.py install

to install the remaining dependencies.

To run the tests, you also need to call

pip install pytest pytest-capturelog

before actually running the tests with

python setup.py test

or with

py.test -v

Mac OS X

Please use our DMG package for a simple installation.

If you want to test the current git version or contribute to the project.

You can follow this instructions with virtualenwrapper: http://virtualenvwrapper.readthedocs.org/ and homebrew: http://brew.sh/.

brew install python3
mkvirtualenv gns3-server --python=/usr/local/bin/python3.4
python3 setup.py install
gns3server

SSL

If you want enable SSL support on GNS3 you can generate a self signed certificate:

bash gns3server/cert_utils/create_cert.sh

This command will put the files in ~/.config/GNS3/ssl

After you can start the server in SSL mode with:

python gns3server/main.py --certfile ~/.config/GNS3/ssl/server.cert --certkey ~/.config/GNS3/ssl/server.key --ssl

Or in your gns3_server.conf by adding in the Server section:

[Server]
certfile=/Users/noplay/.config/GNS3/ssl/server.cert
certkey=/Users/noplay/.config/GNS3/ssl/server.key
ssl=True

Metadata

Release files for gns3-server 1.4.0alpha2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gns3-server 1.4.0alpha2
File Size Uploaded
gns3-server-1.4.0alpha2.tar.gz 181.4 kB Details

Release files / gns3-server-1.4.0alpha2.tar.gz

Download URL gns3-server-1.4.0alpha2.tar.gz
Size 181.4 kB
Tags Source
SHA-256 checksum
How to use checksums
f66046e5ad27923a9c7ea1371fa92d7f35e7a386bf1b0de52c34aa0c23afe2be
BLAKE2b-256 checksum
How to use checksums
0b9bdee6d866956428272d49081672bb68af65c61194579aeeaa79f9b6efcb94
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

3.0.6

2 release files

3.0.5

2 release files

3.0.4

2 release files

3.0.3

2 release files

3.0.2

2 release files

3.0.1

2 release files

3.0.0

2 release files

2.2.61

2 release files

2.2.60

2 release files

2.2.58

2 release files

2.2.57

2 release files

2.2.56

1 release file

2.2.55

1 release file

2.2.54

1 release file

2.2.53

1 release file

2.2.52

1 release file

2.2.51

1 release file

2.2.50

1 release file

2.2.49

1 release file

2.2.48

1 release file

2.2.47

1 release file

2.2.46

1 release file

2.2.45

1 release file

2.2.44

1 release file

2.2.43

1 release file

2.2.42

1 release file

2.2.41

1 release file

2.2.40

1 release file

2.2.39

1 release file

2.2.38

1 release file

2.2.37

1 release file

2.2.36

1 release file

2.2.35

1 release file

2.2.34

1 release file

2.2.33

1 release file

2.2.32

1 release file

2.2.31

1 release file

2.2.30

1 release file

2.2.29

1 release file

2.2.28

1 release file

2.2.27

1 release file

2.2.26

1 release file

2.2.25

1 release file

2.2.24

1 release file

2.2.23

1 release file

2.2.22

1 release file

2.2.21

1 release file

2.2.20

1 release file

2.2.19

1 release file

2.2.18

1 release file

2.2.17

1 release file

2.2.16

1 release file

2.2.15

1 release file

2.2.14

1 release file

2.2.13

1 release file

2.2.12

1 release file

2.2.11

1 release file

2.2.10

1 release file

2.2.9

1 release file

2.2.8

1 release file

2.2.7

1 release file

2.2.6

1 release file

2.2.5

1 release file

2.2.3

1 release file

2.2.2

1 release file

2.2.1

1 release file

2.2.0

1 release file

2.1.21

1 release file

2.1.20

1 release file

2.1.19

1 release file

2.1.18

1 release file

2.1.17

1 release file

2.1.16

1 release file

2.1.15

1 release file

2.1.14

1 release file

2.1.13

1 release file

2.1.12

1 release file

2.1.11

1 release file

2.1.10

1 release file

2.1.9

1 release file

2.1.8

1 release file

2.1.7

1 release file

2.1.6

1 release file

2.1.5

1 release file

2.1.4

1 release file

2.1.3

1 release file

2.1.2

1 release file

2.1.1

1 release file

2.1.0

1 release file

2.0.3

2 release files

2.0.2

2 release files

2.0.1

2 release files

2.0.0

2 release files

1.5.4

2 release files

1.5.3

1 release file

1.5.2

1 release file

1.5.1

1 release file

1.5.0

1 release file

1.4.6

1 release file

1.4.5

1 release file

1.4.4

1 release file

1.4.3

1 release file

1.4.2

1 release file

1.4.1

1 release file

1.4.0

1 release file

This release

1.4.0alpha2 This release

1 release file

1.3.13

1 release file

1.3.12

1 release file

1.3.11

1 release file

1.3.10

1 release file

1.3.9

1 release file

1.3.8

1 release file

1.3.7

1 release file

1.3.6

1 release file

1.3.4

1 release file

1.3.3

1 release file

1.3.2

1 release file

1.3.1

1 release file

1.3.0

1 release file

1.2.3

1 release file

1.2.2

1 release file

1.2.1

1 release file

1.2

1 release file

1.1

1 release file

1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page