Awesome
<p align="center"> <a href="https://github.com/TobySuch/Shifter"> <img alt="Shifter Logo" src="shifter/static/img/logo.svg"/> </a> </p> <p align="center"> <a href="https://github.com/TobySuch/Shifter/actions"> <img alt="Test Status" src="https://github.com/TobySuch/Shifter/actions/workflows/main.yml/badge.svg?branch=main"/> </a> <a href="https://github.com/TobySuch/Shifter/blob/main/LICENSE"> <img alt="MIT License" src="https://img.shields.io/github/license/TobySuch/Shifter.svg"/> </a> <a href="https://github.com/TobySuch/Shifter/releases"> <img alt="Current Release" src="https://img.shields.io/github/release/TobySuch/Shifter.svg"/> </a> </p>Shifter is a simple self-hosted file-sharing web app built using Django and Tailwind. It allows you to quickly and easily upload files and share download links with others.
<p align="center"> <img alt="Shifter Demo GIF" src="docs/ShifterDemo.gif"/> </p>Features:
- Upload files and share download links with others.
- Upload multiple files and automatically create a zip archive.
- Files are automatically deleted once they expire.
- Manage your uploaded files, delete them early.
- Create multiple accounts to allow others to upload files.
- Admin interface for managing site settings such as maximum file size and expiry time.
Built using:
Running in production
This project is still in development and may not be suitable to use in production yet depending on your requirements. Some features are incomplete or non-existent. Existing features are subject to change and may not be backwards compatible. If you would like to use this project in production, please be aware of this and proceed with caution, especially when you update. Non-backwards compatible changes will be listed in the release notes.
Before you begin, make sure you have installed Docker and Docker Compose on your system. If you're not sure how to do this, refer to the Docker documentation for instructions.
By default, the docker-compose.yml
will use the latest image from GHCR. However it still requires some config files from this repository, and the relative paths are important. This will be improved in the future.
- Download or clone this repository.
- Make a copy of the
.env EXAMPLE
file and name it.env
. In your new copy, make sure DEBUG is set to 0, and change any values that are set toCHANGEME
to the appropriate values for your deployment. - In the .env file, update the DJANGO_ALLOWED_HOSTS and CSRF_TRUSTED_ORIGINS values to match your deployment.
- Start the containers using the following command:
docker compose -f docker/docker-compose.yml up
- To create an admin user, run the following command and follow the prompts:
docker compose -f docker/docker-compose.yml exec web python manage.py createsuperuser
- After creating the admin user, you will be able to log into the site using the credentials you entered.
Using Postgresql
By default, Shifter uses SQLite for its database. If you would like to use Postgresql instead, you can do so by following these steps:
- In the
docker-compose.yml
file, uncomment out thedb
service. - In the
.env
file, make sure to change theDATABASE
variable topostgresql
. - Ensure the other postgres variables are set to the appropriate values for your deployment.
SQL_HOST
andSQL_PORT
usually won't need changing if you are using the default postgres configuration from thedocker-compose.yml
file.
Installation Instructions (development):
These instructions are for setting up the project in development mode which may aid you in contributing. Before you begin, make sure you have installed Docker and Docker Compose on your system. If you're not sure how to do this, refer to the Docker documentation for instructions.
- Download or clone this repository.
- Make a copy of the
.env EXAMPLE
file and name it.env.dev
. In your new copy, make sureDEBUG
is set to 1, and change any values that are set toCHANGEME
to the appropriate values for your development environment. - In the .env.dev file, add values for the following variables:
DJANGO_SUPERUSER_EMAIL
andDJANGO_SUPERUSER_PASSWORD
. These will be used to create an admin user when the containers are started. For example:
DJANGO_SUPERUSER_EMAIL=admin@mydomain.com
DJANGO_SUPERUSER_PASSWORD=CHANGEME
- Build and start the development containers using the following command:
docker compose -f docker/dev/docker-compose.dev.yml up --build
- Once the containers are running, you should be able to access the site in your web browser at
127.0.0.1:8000
. By default, the admin user will automatically be created and you will be able to log in using the credentials you entered in the .env.dev file.
If you would like contribute to this project, please read the contributing guidelines for more information.