Skip to content
Pocket Homelab
Get the appComing soon to the App Store

Pocket Horoscope

v0.3.3 · Self-hosted · MIT

Astrology from the real sky, on your own server.

Pocket Horoscope works out where the Sun, Moon and planets really are, then builds birth charts for you and the people you care about, a daily horoscope from today’s planets against your own chart, compatibility between any two people and the Moon calendar. A daily check-in shows whether the Moon really changes your days.

Get it on GitHubHow to run it
Pocket Horoscope on an iPhone: today’s headline, an overall score of 70 and scores for love, work, mood and energyPocket Horoscope on an iPhone: today’s headline, an overall score of 70 and scores for love, work, mood and energy

Your day

Today’s planets against your chart.

Each day gets a headline and scores for love, work, mood and energy. The transits that count for you are explained in plain words, next to the Moon’s sign, phase and house and its quiet hours.

The Today page: a headline, four scores, the transits that touch the chart and a card about the Moon in CancerThe Today page: a headline, four scores, the transits that touch the chart and a card about the Moon in Cancer

Birth charts

A chart for everyone you keep.

The wheel with houses and aspects, the Big Three and a few plain sentences for every planet in its sign and house and every aspect. It stays readable at phone size.

  • Placidus, Koch, Whole sign, Equal or Porphyry houses
  • No birth time? Everything but the rising sign and houses
  • Positions within a few arc-seconds of NASA JPL for 1900–2050
A birth chart on an iPhone: the wheel with planets, houses and coloured aspect linesA birth chart on an iPhone: the wheel with planets, houses and coloured aspect lines

Compatibility

Two charts laid over each other.

Pick any two people and see one chart inside the other, a short verdict, how their elements compare, and scores for love, talking, trust, fun and growth.

  • The strongest links and the hard spots, in words
  • Works for partners, family, friends and colleagues
Compatibility of two made-up people: a score of 70, five category bars, the two charts overlaid and their elementsCompatibility of two made-up people: a score of 70, five category bars, the two charts overlaid and their elements

Journal

Does the Moon change your days?

A daily check-in keeps your mood, energy and a note with that day’s sky. Insights then compare your mood with the Moon’s phase, element and sign, and say plainly what they find.

  • Look at three months, a year or everything
  • With Pocket Health, your sleep and resting heart rate too
You and the Moon: findings about mood and the Moon, and bar charts of mood and energy by Moon phase, element and signYou and the Moon: findings about mood and the Moon, and bar charts of mood and energy by Moon phase, element and sign

And the rest of it

  • The sky and what is coming

    Where everything is right now, the Moon calendar with phases, signs, void-of-course hours and eclipses, the year’s retrogrades, and your transits for the weeks ahead with their exact days.

  • Written readings

    With Pocket AI or your own OpenAI key: your day, a whole chart, a match, the year ahead or any question. Keep them, delete them or save them to Pocket Notes.

  • Morning horoscope and Moon alerts

    Through Apprise, ntfy or a webhook: your morning horoscope, new and full Moons, eclipses, planets turning retrograde or direct, and birthdays.

  • Bring your people

    Import birthdays from Pocket Contacts, an AAF file from most astrology programs, or a CSV. Place search finds a birth place’s coordinates and time zone.

  • Everyone their own

    Each person has their own people, journal, readings and settings. Admins see no one else’s.

Install

One container, one volume.

Pocket Horoscope is a single Go binary with a SQLite file. Open it, create the first account and add yourself. Place search uses Open-Meteo’s free geocoder; set GEOCODER_URL=off to type coordinates by hand. With Pocket Core, people sign in once and birthdays, notes and health data arrive with nothing to paste.

On a Pocket Box it is already installed and signed in through Pocket Core.

Every setting in the README →

docker run -d --name pocket-horoscope -p 8080:8080 -v ./data:/data \
  -e BASE_URL=https://horoscope.example.com -e SECURE_COOKIES=true \
  ghcr.io/abjelosevic88/pocket-homelab-horoscope:latest

More in Everyday life