Shorten URLs with invisible spaces.
Or, configure your own instance to use any other kinds of characters.
This project exists thanks to all the people who contribute.
Become a financial contributor and help us sustain our community. [Contribute]
Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]
A status page for the official zws.im instance of ZWS is available at status.zws.im.
Running an instance of ZWS on Heroku is the easiest way to self-host. You can also stay totally within the free limits of both the
web process and the Heroku Postgres database. Note that the Hobby Dev (free) plan of Heroku Postgres has a row limit of 10,000, which might not be enough for your use case.
db.env and fill in the values
.env and update the
DATABASE_URL environment variable to match the values in
docker-compose up -d (this will automatically apply database migrations)
After you create an app using the above button you'll need to run the database migrations before shortening any URLs. These are done automatically, but manual usage may be required when upgrading versions.
This can be done easily through Docker Compose by running the following commands:
docker volume create --name=zws-postgres-storagedocker-compose up migration
Even if your database isn't being run through Docker Compose you'll still need to create the volume and start the
db service. You can delete the volume right after. If you know a better way to do this, please open a pull request!
If you are using a Heroku database migrations are automatically applied, but to manually do so you'll need the credentials for your database:
.env file and enter in the connection URI
Afterward you can run the migration commands shown above.
ZWS instances expose two routes that implement the Shields endpoint schema:
Number of shortened URLs
Number of visited URLs