一个非常简洁的图床程序，适合自己个人使用。
界面也是极简的。
An open-source self hosted image sharing platform.
About
ShotShare is an open source, self hosted, bare bones image posting/sharing platform, it was built to allow friends to upload screenshots and send links to their friends without the constant barrage of ads/extraneous features.
Demo
A demo may be found here. This environment is strictly for trialing the application; images added here are automatically after a few minutes.
Installation, Configuration, & Local Development
ShotShare is meant to be extremely easy to self host. Below is a sample deployment using Docker.
Example Deployment with Docker
- Create a directory for ShotShare:
sudo mkdir /shotshare - Create a
.envfile that will manage ShotShare generated environment variables (ex. your application key):sudo touch /shotshare/.env - Ensure the user/group 82 (
www-datauser in docker container) own the.envfile:sudo chown 82:82 /shotshare/.env - Start the ShotShare container
You may wish to customize environment variables (such as the HOST) before running this command, see below for a list of environment variables.docker run \ -p 80:80 \ -p 443:443 \ -e HOST=localhost \ -v shotshare_caddy_data:/data \ -v shotshare_caddy_config:/config \ -v shotshare_database:/app/database \ -v shotshare_data:/app/storage \ –mount type=bind,source=/shotshare/.env,target=/app/.env \ -d \ –restart unless-stopped \ –name shotshare \ mdshack/shotshare:latest
Configuration Options
Note: These are not all of the configuration options, only the most used ones, feel free to open a PR if you see any missing. For a more in-depth look at all the available options check out here.
| Environment Variable | Default | Options | Description |
|---|---|---|---|
DB_CONNECTION |
sqlite |
sqlite,mysql,pgsql,sqlsrv |
Indicates what database connection will be used |
DB_HOST |
127.0.0.1 |
N/A | Not required if using sqlite, indicates the database host |
DB_PORT |
3306 |
N/A | Not required if using sqlite, indicates the database port |
DB_DATABASE |
shotshare |
N/A | Not required if using sqlite, indicates the database database |
DB_USERNAME |
shotshare |
N/A | Not required if using sqlite, indicates the database username |
DB_PASSWORD |
none | N/A | Not required if using sqlite, indicates the database password |
HOST |
localhost | N/A | Public host used by Caddy, thanks to caddy, this host will automatically be issued a SSL certificate |
Local Development
Local development is done using docker compose
- Pull the repo:
git clone git@github.com:mdshack/shotshare.git - Change to the ShotShare directory:
cd shotshare - Install dependencies:
composer install; npm install - Build frontend:
npm run build - Start docker compose:
docker compose up
Contributing
There is currently no established pattern for contributing, if you see something missing or feel like something could be better feel free to pop open an issue and/or PR.
License
ShotShare is open-sourced and licensed under the MIT License.
