Photon
Jump to:
A better, more intuitive way to use Lemmy, with a cleaner UI, more features, and snappier usage.
Photon's design philosophy is easy: all features must be intuitive and simple. If a feature can't be easily slipped in while making sense, it will not be added.
Put Photon on your own domain for easier onboarding.
# Use the env var PUBLIC_INSTANCE_URL to set the default instance URL.
docker run -p 8080:3000 -e PUBLIC_INSTANCE_URL=example.com ghcr.io/xyphyn/photon:latest
More unstable but latest features
Clone the repo:
git clone https://github.com/Xyphyn/photon && cd photon
and run the docker container:
docker build -t photon .
# Use the env var PUBLIC_INSTANCE_URL to set the default instance URL.
docker run -p 8080:3000 -it photon:latest
There you go, you now have an instance of Photon running.
The most common settings you'll use are PUBLIC_INSTANCE_URL
. Some selfhosters with PUBLIC_SSR_ENABLED
set to true might want the instance url to be different for the server. You can use the PUBLIC_INTERNAL_INSTANCE
variable for that.
PUBLIC_MIGRATE_COOKIE
is useful if you want to switch Photon to your default frontend. It'll convert the logged in cookie from lemmy-ui to a Photon account. It will only work if you have PUBLIC_INSTANCE_URL
set, and it will login with that instance.
PUBLIC_SSR_ENABLED
will have the initial load be rendered by the server, before the client router is loaded. This can lead to a faster feeling load initally, and will allow your instance to be better indexed by search bots, and allow users with JavaScript disabled to view Photon with a basic view.
These are the most important environment variables that you can change:
Variable | Values | Default Value |
---|---|---|
PUBLIC_INSTANCE_URL | URL | lemmy.ml |
PUBLIC_INTERNAL_INSTANCE | URL | Value of PUBLIC_INSTANCE_URL |
PUBLIC_LOCK_TO_INSTANCE | bool |
true if PUBLIC_INSTANCE_URL is set |
PUBLIC_FAVICON | URL | `/img/logo-background.svg |
PUBLIC_SSR_ENABLED | bool |
false |
PUBLIC_MIGRATE_COOKIE | bool |
false |
PUBLIC_THEME | system|dark|light | system |
PUBLIC_EXPANDABLE_IMAGES | bool |
true |
PUBLIC_MARK_READ_POSTS | bool |
true |
PUBLIC_DEFAULT_FEED_SORT | SortType |
Active |
PUBLIC_DEFAULT_FEED | ListingType |
Local |
PUBLIC_DEFAULT_COMMENT_SORT | CommentSortType |
Hot |
PUBLIC_HIDE_DELETED | bool |
true |
PUBLIC_HIDE_REMOVED | bool |
true |
PUBLIC_NSFW_BLUR | bool |
true |
PUBLIC_RANDOM_PLACEHOLDERS | bool |
true |
PUBLIC_REMOVE_CREDIT | bool |
false |
There are more options available that you can see at src/lib/settings.ts
, by looking at the defaultSettings
object.
The values for SortType
, ListingType
, and CommentSortType
are defined by the lemmy-js-client library.
https://github.com/LemmyNet/lemmy-js-client/blob/main/src/types/ListingType.ts
- All
- Local
- Subscribed
- Moderator
(case sensitive)
https://github.com/LemmyNet/lemmy-js-client/blob/main/src/types/SortType.ts
- Active
- Hot
- New
- Old
- TopDay
- TopWeek
- TopMonth
- TopAll
- MostComments
- NewComments
- TopHour
- TopSixHour
- TopTwelveHour
- TopThreeMonths
- TopSixMonths
- TopNineMonths
- TopYear
https://github.com/LemmyNet/lemmy-js-client/blob/main/src/types/CommentSortType.ts values:
- Hot
- Top
- New
- Old
- Controversial
Want your instance added here? Make a GitHub issue or make a PR! (this is for general purpose Photon instances.)
phtn.app is the official instance and will get updates instantly.
Instance | Location | Contact |
---|---|---|
phtn.app (Official) | ๐บ๐ธ US West | photon@xylight.dev |
ph.opnxng.com | ๐ธ๐ฌ Singapore | about.opnxng.com |
photon.thesanewriter.com | ๐บ๐ธ US East | thesanewriter@lemmy.thesanewriter.com |
p.darrennathanael.com | ๐บ๐ธ US East | noc@darrennathanael.com |
p.lemmy.ohaa.xyz | ๐ฆ๐น Austria | (???) |
๐ฎ๐ธ Iceland | zhenyapav@zhenyapav.com | |
๐บ๐ธ US East | admin@buckodr.ink | |
phtn.ngn.tf | ๐น๐ท Turkey | services@ngn.tf |
You can donate at Buy me a Coffee