skip to navigation
skip to content

sirepo 20171012.224549

accelerator code gui

Latest Version: 20171017.232551

# ![Sirepo](

<p align="center">

## Sirepo brings computational science to the cloud.

Develop, run and share your HPC simulations.

Sirepo brings Clickable Physics(TM) to your desktop and mobile devices.

Run Sirepo directly from [our beta site](

No signup is required and Sirepo is completely free.

### If you prefer, Sirepo can also be downloaded! :arrow_down:
1. Curl Installer
2. Install with Docker
3. Install with Vagrant

#### Curl Installer
You can use our
[curl installer on your Mac, PC (Cygwin only), or Linux box](
as follows:

$ mkdir sirepo
$ cd sirepo
$ curl | bash

For this to work, you will need to [install the prerequisites](

[API Documentation is available on Read the Docs.](

#### Manual Install with Docker

You can start Sirepo with [Docker](

If you are running Docker as an ordinary user (recommended), use the following:

$ docker run -p 8000:8000 -v "$PWD:/sirepo" radiasoft/sirepo

The `/radia-run` command ensures the guest's user can read/write files from the
current directory, which is where the database and other files will be stored.

Then visit the following link:


#### Manual Install with Vagrant

You can start Sirepo with [Vagrant](

First create a `Vagrantfile` by copy-and-pasting this into a shell:

cat > Vagrantfile <<'EOF'
Vagrant.configure(2) do |config| = "radiasoft/sirepo" "forwarded_port", guest: 8000, host: 8000
config.vm.synced_folder ".", "/vagrant", disabled: true

Boot the machine:

vagrant up

The image is 2.5GB so this will take some time to start.

If it's your first time running Vagrant, it will ask to install VirtualBox.

Follow the prompts

You can run Sirepo with a single command:

vagrant ssh -c '. ~/.bashrc; sirepo service http'

Or, if you would like to do development:

vagrant ssh
cd src/radiasoft
pip uninstall sirepo pykern
git clone
cd pykern
pip install -e .
cd ..
git clone
cd sirepo
pip install -e .
sirepo service http

Then visit the following link:


##### Sharing Folder with Vagrant VM

Note that if you want to transfer files to the virtual machine,
you'll need to install the
[vagrant-vbguest plugin](
and remove the following line from the `Vagrantfile`:

config.vm.synced_folder ".", "/vagrant", disabled: true

## Development

To start developing on vagrant, you should do the following:

curl | bash -s vagrant-centos7
vagrant ssh
curl | bash -s sirepo-dev

Not yet supported, but to install Opal:

$ curl | bash -s code pyOPALTools trilinos opal

### Full Stack Development

The `sirepo service http` setup is used for basic application development.
However, if you want to test the full stack workflow, you'll need to start
all the support processes and configure your servers.

Set up a few environment variables:


Then run each of the following commands in separate windows:

sirepo service rabbitmq
sirepo service celery
sirepo service uwsgi
sirepo service nginx_proxy
sirepo service flower

[nginx]( will listen on port 8080 so you can browse
Sirepo at [http://localhost:8080](http://localhost:8080). The
middle tier [uwsgi]( server
will start on port 8000.

The last process starts [Flower](,
which allows you to monitor [Celery](
You can visit [http://localhost:5555](http://localhost:5555)
to see the workers, tasks, processes, queues, etc.

You can also visit
[RabbitMQ's Management Plugin](
on this URL:

### License


Copyright (c) 2015-2016 [RadiaSoft LLC]( All Rights Reserved.

File Type Py Version Uploaded on Size (md5) Source 2017-10-12 38MB