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

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.