e56d700d2e | ||
---|---|---|
.github/workflows | ||
.vscode | ||
example | ||
packages | ||
.dockerignore | ||
.gitignore | ||
.pnpmfile.cjs | ||
.prettierrc | ||
.syncpackrc | ||
Dockerfile | ||
LICENSE | ||
README.md | ||
compose.yml | ||
package.json | ||
pnpm-lock.yaml | ||
pnpm-workspace.yaml | ||
turbo.json | ||
wrapper.sh |
README.md
micro
A vanity file sharing service with support for ShareX. You can see a preview at https://micro.sylo.digital
features
- ShareX Support
- Video and image thumbnails
- Config generation
- Encrypted pastes
- File name preservation
- Video, image, text and markdown previews
- Syntax highlighting for supported files
- Deletion URLs
- Dashboard
- Permissions
- Invite links
- URL Shortening
- Mobile support
- EXIF metadata removal
- Conversions (GIF>WebM, WebP>PNG, etc.)
- Purging of old and/or large files (
config.purge
). - 2FA support
screenshots
installation
[!NOTE] If you need help, join the discord server. This guide assumes you are on linux with a basic understanding of linux and docker.
[!TIP] If you are already familiar with docker, you can look at the compose file and config file to get setup quickly. The below is a more detailed guide for inexperienced users.
- Install
git
anddocker
- Download the files in this repository,
git clone https://github.com/sylv/micro.git
- Copy the example configs to the current directory,
cp ./micro/example/* ./
- Fill out
.microrc.yaml
,Caddyfile
anddocker compose.yml
. It is extremely important you read through each of the 3 files and make sure you understand what they do. Specifically,.microrc.yaml
contains a secret that handles authentication, if it is not a secure random string everyone can sign in as anyone they want without a password. - Run
docker compose up -d
to start the database and micro. - Get the startup invite by doing
docker compose logs micro
and copying the invite URL that should be somewhere towards the end of the log. Go to that URL to create the first account.
Setup is now complete and your instance should be working.
To add another user, sign in then go to /api/invite
and copy the URL it gives you. This will be improved in the future.
configuration
micro uses venera to load configuration files. Configuration files are validated on startup, and may log errors if invalid setups are detected. The venera page has more information, but tl;dr:
.microrc.yaml
is the main configuration file.- You can override any config value with an environment variable. The key
hosts.0.url
would be set asMICRO_HOSTS__0__URL
- You can use other file formats, like JSON or TOML.
updating
You should take a full database backup before updating, but you won't, will you? The database will be automatically migrated on startup.
docker compose pull micro
docker compose up -d micro
development
You can pull the repo and then pnpm install
, after that everything should be good to go. You can start the packages/api
/packages/web
with pnpm watch
.
web
package notes
[!IMPORTANT] tl;dr,
web
is quirky and some packages that depend on react may break. if they do, try adding them tonoExternal
in vite.config.ts and they'll probably work.
The web package is a little weird. It uses vike in place of what might normally be nextjs, preact in place of react and vite to build it all. Unlike nextjs, we have much more control over rendering, SSR, routing, etc. It's much faster, and much more fun. Of course, nothing is free - some hacky workarounds are required to get it working.
Preact is smaller, faster, and more fun than react. It's a drop-in replacement, but actually dropping it in is the hard part. The main problem is that in SSR mode, vite does not bundle dependencies, which means aliasing react
to preact
does not work because it's not transforming the packages to replace the react imports. You can force it to bundle dependencies, but then it chokes on some node dependencies like fastify. The only way I've found to get around this is to:
- Alias
react
topreact
in node_modules using.pnpmfile.cjs
- Add some packages that still complain to
noExternal
invite.config.ts
, which forces them to be bundled and appears to resolve any remaining issues.
tsup
is used as a final build step to bundle everything together. Vite breaks doing this, but not doing it results in much larger docker images.
todo
- Ratelimiting
- Admin UI
- Deletion URLs for pastes/links
- Password recovery via emails
- SQLite support
- Private email aliases like firefox relay (might be difficult/expensive)