# Installing cState with Docker

cState can run on Docker for both production and development purposes. 

## Building the Image

cState (currently) doesn't have a publicly built image, so it must be built manually. You can do this on any machine that has
Docker and Git installed.

1. Clone the main cState repository: `git clone https://github.com/cstate/cstate`
2. Navigate to the cState directory: `cd cstate`
3. Build the image: `docker build -t cstate .` (note: you can add :[version] after cState if you wish to have multiple versions of cState available).


## Run the Container

Once you've built (or pulled) the container, you can run cState. 

`docker run -p 8080:80 --name=cstate -v /var/cstate:/app cstate`

> You can replace 8080 with any other port, this is where cState will listen on the host computer.

> You can replace /var/cstate with any other path, this is where cState's files will be stored, the user managing cState will need access to this directory. 

## Reloading Modifications

Once files have been modified locally, the site must be rebuilt with Hugo. The easiest way to do this is to simply restart the container.

`docker restart cstate`

If restarting the container isn't a possibility, you can manually run hugo with docker exec

\`\`\`
docker exec -it cstate /bin/ash
cd /app
hugo
cp -r /app/public/* /usr/share/nginx/html
\`\`\`