Skip to content

Webapp AS Visualization

Webapp Setup

Webapp is a Go application that will serve up a static web portal to make it easy to visualize and experiment with SCIONLab test apps on a virtual machine.


mkdir $GOPATH/src/
cd $GOPATH/src/
git clone
cd scion-apps
make install


To install webapp (and all SCIONLab apps) and get dependencies as listed in vendor file:

make install



If the old scion-viz web server is running on your SCIONLab VM, port 8000 may still be in use. To remedy this, before vagrant up, make sure to edit your vagrantfile to provision an alternate port for the webapp web server. Add this line for a different port, say 8080 (for example, just choose any forwarding port not already in use by vagrant, and use that port everywhere below): "forwarded_port", guest: 8080, host: 8080, protocol: "tcp"

To run the Go Web UI at a specific address (-a) and port (-p) like for a SCIONLab VM use:

cd webapp
webapp -a -p 8000

Now, open a web browser at, to begin.

Browser AS Visualizations

Several menu options are available at the top of each webapp page, which are outlined below. Each of the features below use your SCIONLab IA the the source address.


The Health tab is the landing page for webapp that will automatically test your SCIONLab configuration for configuration and communication health. Additional help is available in our troubleshooting guide, if needed.

SCIONLab download page


The Apps tab provides a portal to SCIONLab Apps, and uses your Source IA and a Destination IA you specify to test with. Some default Destination IAs are already provided for you, but you can always change them and click Update Paths.


The announced paths will be displayed in a combined topology in the window. To view the details of a specific path expand the path's data by clicking on the path number in the window on right side. You may also view a global map of selected paths by clicking the Map switch.


See the SCIONLab Apps Visualization page for details about running SCIONLab Apps.

SCIONLab download page


The Files menu on the page will allow you to navigate and serve any files on the SCIONLab node from the root (-r) directory you specified (if any) when starting webapp.go. To browse the user directory, for example:

webapp -a -p 8000 -r ~

AS Topology

The composition of services and border routers for the Source AS will be displayed in the AS Topology tab. Click on any circle to view the details of that server or router.


The big circle can be clicked on as well to view details of the Source AS.

SCIONLab download page


SCIONLab download page

AS Certificate

SCIONLab download page