Skip to content
This repository has been archived by the owner on Aug 25, 2023. It is now read-only.

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
PassiveLemon committed May 26, 2023
1 parent 607cd87 commit c7964c2
Showing 1 changed file with 33 additions and 31 deletions.
64 changes: 33 additions & 31 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,60 +7,62 @@

Docker container for [Zoraxy](https://github.com/tobychui/zoraxy) </br>

## Setup </br>
There really isn't much here, just make sure you find a good place to store the files. The container will download everything automatically so this place is used to store the files so they aren't deleted when the container is deleted. </br>
## Setup: </br>
There really isn't much here, just make sure you find a good place to store the files on your host. The container will download everything automatically so this place is used to store the files so they aren't deleted when the container is deleted. </br>

### Using Docker run</br>
### Using Docker run </br>
```
docker run -d --name (container name) -p (ports) -v (path to storage directory):/zoraxy/data/ -e ARGS=(your arguments) -e VERSION=(version) passivelemon/zoraxy-docker:latest
```

### Using Docker Compose</br>
### Using Docker Compose </br>
```
version: '3.3'
services:
zoraxy-docker:
container_name: (container name)
ports:
- '80:80' #http port
- '443:443' #https port
- '(wanted port):8000' #Management portal port
volumes:
- '(path to storage directory):/zoraxy/data/'
environment:
- 'ARGS=-port=:8000' #telling Zoraxy what port to listen on for the management portal
image: 'passivelemon/zoraxy-docker:latest'
zoraxy-docker:
image: passivelemon/zoraxy-docker:latest
container_name: (container name)
ports:
- 80:80 # Http port
- 443:443 # Https port
- (wanted port):8000 # Management portal port
volumes:
- (path to storage directory):/zoraxy/data/ # Host directory for Zoraxy file storage
environment:
ARGS: '-port=:8000' # Telling Zoraxy what port to listen on for the management portal. Changing this means building the image yourself with your own exposed port. Might change in the future.
```

| Operator | Need | Details |
|:-|:-|:-|
| `-d` | Yes | will run the container in the background. |
| `--name (container name)` | No | Sets the name of the container to the following word. You can change this to whatever you want. |
| `-v (path to storage directory):/zoraxy/data/` | Yes | Sets the folder that holds your files. This should be the place you just chose. |
| `-v (path to storage directory):/zoraxy/data/` | Recommend | Sets the folder that holds your files. This should be the place you just chose. By default, it will create a Docker volume for the files for persistency but they will not be accessible. |
| `-e ARGS=(your arguments)` | No | Sets the arguments to run Zoraxy with. By default, it is ran with `-port=:8000 -noauth=false` |
| `-e VERSION=(version)` | No | Sets the version of Zoraxy that the container will download. Must be a supported version found on the Zoraxy Github. Defaults to the latest if not set. |
| `passivelemon/zoraxy-docker:latest` | Yes | The repository on Docker hub. By default, it is the latest version that I have published. |

#### Example:
### Docker Run
## Examples: </br>
### Docker Run </br>
```
docker run -d --name zoraxy -p 8000:8000/tcp -v /home/docker/Containers/Zoraxy:/zoraxy/data/ -e ARGS="-port=:8000 -noauth=false" passivelemon/zoraxy-docker:latest
```

### Docker Compose
### Using Docker Compose</br>
### Docker Compose </br>
```
version: '3.3'
services:
zoraxy-docker:
container_name: zoraxy
ports:
- '80:80' #http port
- '443:443' #https port
- '8000:8000' #Management portal port
volumes:
- '/home/docker/Containers/Zoraxy:/zoraxy/data/'
environment:
- 'ARGS=-port=:8000' #telling Zoraxy what port to listen on for the management portal
image: 'passivelemon/zoraxy-docker:latest'
zoraxy-docker:
image: passivelemon/zoraxy-docker:latest
container_name: zoraxy
ports:
- 80:80
- 443:443
- 8000:8000
volumes:
- /home/docker/Containers/Zoraxy:/zoraxy/data/
environment:
ARGS: '-port=:8000'
```

### Other </br>
If the container doesn't start properly, you might be rate limited from GitHub for some amount of time. You can check this by running `curl -s https://api.github.com/repos/tobychui/zoraxy/releases` on the host. If you are, you will just have to wait for a little while or use a VPN. </br>

0 comments on commit c7964c2

Please sign in to comment.