Git Product home page Git Product logo

picon's Introduction

PiCon.app

  • 'Appified' container runs a Linux virtual machine using the hypervisor framework built into macOS. No additional software is required (Docker, VMware Fusion, VirtualBox, etc...)
  • Deploys a standard Deban 12 cloud image and installs Pi-hole + Unbound with minimal user input.

Info

  • Intel and Apple Silicon are both natively supported. Works on any Mac built after 2010.
  • Requires macOS 10.13 or newer, bridged networking requires macOS 10.15 or newer.
  • Container uses 1/16th of the host Mac's RAM, up to 1GB. For example, a Mac with 4GB RAM will create a 256MB virtual machine.
  • Pi-hole is persistent and starts automaticaly with your Mac using a system LaunchDaemon.
  • PiBar is configured during installation and appears in your menu bar at login.
  • Useful for MacBook users "on the go" or as an ad-blocking DNS server for an entire network.

Install

If you have an older version of PiCon installed, reset it first by holding down Option [ ⌥ ] while opening the app.

  • Download PiCon to your Mac.
  • Double-click the zip archive to extract its contents (Some browsers will extract the archive automatically).
  • Move PiCon.app to your /Applications folder. This step is mandatory as the app expects to be in this location to run.

The first time the app is opened you will need to acknowledge a warning by Gatekeeper. The app is digitally signed to protect against tampering but not notarized by Apple. You can verify the signature by running codesign -dv /Applications/PiCon.app

Install Screenshots

  • First-run setup: image
  • Wait a few moments for the container to initialize. When complete, the install summary will appear.
  • Your web browser will open the Pi-hole admin page. Paste your clipboard into the Pi-hole password field. image

Post-Install Screenshots

  • PiBar is configured automatically and set to run at login.

image

  • Launch PiCon.app if you need to access the container's console. image
  • Hold down [Shift] while launching PiCon.app to restart the container.
  • Hold down Option [ ⌥ ] to reset the container and start fresh.
    image

picon's People

Contributors

desktopecho avatar

Stargazers

 avatar  avatar  avatar  avatar

Watchers

 avatar

Forkers

vavavr00m

picon's Issues

Change unbound port

If started to install the latest version of PiCon on macOS Sonoma Mac Mini M1.
How can I change the preconfigured unbound port 5335 to something else?
On Raspberry Pi it's just one place in the unbound.conf.
Here I sah several places and I'm not sure if I found all of them.
Thank you for feedback.
Kind regards

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.