{"id":2139,"date":"2016-11-18T16:35:48","date_gmt":"2016-11-18T15:35:48","guid":{"rendered":"https:\/\/denbeke.be\/blog\/?p=2139"},"modified":"2016-11-18T16:42:32","modified_gmt":"2016-11-18T15:42:32","slug":"running-gogs-go-git-service-as-a-service-on-macos-os-x-server","status":"publish","type":"post","link":"https:\/\/denbeke.be\/blog\/software\/running-gogs-go-git-service-as-a-service-on-macos-os-x-server\/","title":{"rendered":"Running Gogs (Go Git Service) as a service on macOS X server"},"content":{"rendered":"

\"favicon.ico\"<\/a>This guides explains how you can run Gogs<\/a> git server as a service on your Mac using launchd<\/em>.<\/p>\n

Command line tools<\/h3>\n

First you need to install Xcode from the Mac App Store<\/a>. Once installed, you also need the Command Line Tools<\/em>, you can initiate the download process by executing $ xcode-select --install<\/code> in the Terminal.<\/p>\n

The command line tools include Git.<\/p>\n

MySQL or PostgreSQL server<\/h3>\n

You also need a database server for Gogs. You can install MySQL using MacPorts. A good tutorial can be found here<\/a>.<\/p>\n

You can alternatively run MariaDB instead of MySQL. My blogposts about MAMP (using MacPorts)<\/a> includes a section about MariaDB.<\/p>\n

Installing and configuring Gogs<\/h3>\n

I could try to write a good tutorial here, but the developers of Gogs already made a very nice tutorial about how you can install and configure Gogs. Read it here<\/a>.<\/p>\n

Launchd config<\/h3>\n

Create a launchd<\/em> config file ~\/Library\/LaunchAgents\/io.gogs.web.plist<\/code><\/p>\n

<?xml version=\u201d1.0\" encoding=\u201dUTF-8\"?>\r\n<!DOCTYPE plist PUBLIC \u201c-\/\/Apple Computer\/\/DTD PLIST 1.0\/\/EN\u201d \u201chttp:\/\/www.apple.com\/DTDs\/PropertyList-1.0.dtd\">\r\n<plist version=\u201d1.0\">\r\n    <dict>\r\n        <key>Label<\/key>\r\n        <string>io.gogs.web<\/string>\r\n        <key>EnvironmentVariables<\/key>\r\n        <dict>\r\n            <key>HOME<\/key>\r\n            <string>\/Users\/mathias<\/string>\r\n        <\/dict>\r\n        <key>ProgramArguments<\/key>\r\n        <array>\r\n            <string>sh<\/string>\r\n            <string>-c<\/string>\r\n            <string>cd \/Users\/mathias\/Sites\/gogs; .\/gogs web<\/string>\r\n        <\/array>\r\n        <key>UserName<\/key>\r\n        <string>mathias<\/string>\r\n        <key>RunAtLoad<\/key>\r\n        <true\/>\r\n        <key>KeepAlive<\/key>\r\n        <true\/>\r\n        <key>WorkingDirectory<\/key>\r\n        <string>\/Users\/mathias<\/string>\r\n        <key>StandardOutPath<\/key>\r\n        <string>\/Users\/mathias\/Sites\/gogs\/launchd.log<\/string>\r\n        <key>StandardErrorPath<\/key>\r\n        <string>\/Users\/mathias\/Sites\/gogs\/launchd_error.log<\/string>\r\n    <\/dict>\r\n<\/plist><\/code><\/pre>\n
You can now start and stop Gogs using the following commands:<\/p>\n
$ launchctl load ~\/Library\/LaunchAgents\/io.gogs.web.plist\r\n$ launchctl unload ~\/Library\/LaunchAgents\/io.gogs.web.plist<\/code><\/pre>\n
HTTPS proxy<\/h3>\n
I then run Caddy<\/a> in front of Gogs to use Caddy’s built-in automated HTTPS support. My git<\/code> subdomain is then a reverse proxy to Gogs:<\/p>\n
git.my-domain.com {\r\n    proxy \/ http:\/\/localhost:3000\r\n}<\/code><\/pre>\n
More info about running Caddy as a service can be found in this blogpost: Running Caddy as a service on macOS X server<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"
This guides explains how you can run Gogs git server as a service on your Mac using launchd. Command line tools First you need to install Xcode from the Mac App Store. Once installed, you also need the Command Line Tools, you can initiate the download process by executing $ xcode-select –install in the Terminal. […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[235,227,161],"tags":[210,232,151,186],"yoast_head":"\nRunning Gogs (Go Git Service) as a service on macOS X server – DenBeke<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/denbeke.be\/blog\/software\/running-gogs-go-git-service-as-a-service-on-macos-os-x-server\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Running Gogs (Go Git Service) as a service on macOS X server – DenBeke\" \/>\n<meta property=\"og:description\" content=\"This guides explains how you can run Gogs git server as a service on your Mac using launchd. Command line tools First you need to install Xcode from the Mac App Store. Once installed, you also need the Command Line Tools, you can initiate the download process by executing $ xcode-select --install in the Terminal. […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/denbeke.be\/blog\/software\/running-gogs-go-git-service-as-a-service-on-macos-os-x-server\/\" \/>\n<meta property=\"og:site_name\" content=\"DenBeke\" \/>\n<meta property=\"article:published_time\" content=\"2016-11-18T15:35:48+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2016-11-18T15:42:32+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/denbeke.be\/blog\/wp-content\/uploads\/2016\/11\/favicon.ico.png\" \/>\n<meta name=\"twitter:card\" content=\"summary\" \/>\n<meta name=\"twitter:creator\" content=\"@MthsBk\" \/>\n<meta name=\"twitter:site\" content=\"@MthsBk\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\">\n\t<meta name=\"twitter:data1\" content=\"2 minutes\">\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebSite\",\"@id\":\"https:\/\/denbeke.be\/blog\/#website\",\"url\":\"https:\/\/denbeke.be\/blog\/\",\"name\":\"DenBeke\",\"description\":\"Mathias Beke\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":\"https:\/\/denbeke.be\/blog\/?s={search_term_string}\",\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/denbeke.be\/blog\/software\/running-gogs-go-git-service-as-a-service-on-macos-os-x-server\/#primaryimage\",\"inLanguage\":\"en-US\",\"url\":\"https:\/\/denbeke.be\/blog\/wp-content\/uploads\/2016\/11\/favicon.ico.png\",\"width\":143,\"height\":152},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/denbeke.be\/blog\/software\/running-gogs-go-git-service-as-a-service-on-macos-os-x-server\/#webpage\",\"url\":\"https:\/\/denbeke.be\/blog\/software\/running-gogs-go-git-service-as-a-service-on-macos-os-x-server\/\",\"name\":\"Running Gogs (Go Git Service) as a service on macOS X server – DenBeke\",\"isPartOf\":{\"@id\":\"https:\/\/denbeke.be\/blog\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/denbeke.be\/blog\/software\/running-gogs-go-git-service-as-a-service-on-macos-os-x-server\/#primaryimage\"},\"datePublished\":\"2016-11-18T15:35:48+00:00\",\"dateModified\":\"2016-11-18T15:42:32+00:00\",\"author\":{\"@id\":\"https:\/\/denbeke.be\/blog\/#\/schema\/person\/386878f712fe3fe22227216f087772dc\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/denbeke.be\/blog\/software\/running-gogs-go-git-service-as-a-service-on-macos-os-x-server\/\"]}]},{\"@type\":\"Person\",\"@id\":\"https:\/\/denbeke.be\/blog\/#\/schema\/person\/386878f712fe3fe22227216f087772dc\",\"name\":\"Mathias Beke\",\"image\":{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/denbeke.be\/blog\/#personlogo\",\"inLanguage\":\"en-US\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/015ba35e6ce4f5859e3888ca99807575?s=96&d=mm&r=g\",\"caption\":\"Mathias Beke\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","_links":{"self":[{"href":"https:\/\/denbeke.be\/blog\/wp-json\/wp\/v2\/posts\/2139"}],"collection":[{"href":"https:\/\/denbeke.be\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/denbeke.be\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/denbeke.be\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/denbeke.be\/blog\/wp-json\/wp\/v2\/comments?post=2139"}],"version-history":[{"count":3,"href":"https:\/\/denbeke.be\/blog\/wp-json\/wp\/v2\/posts\/2139\/revisions"}],"predecessor-version":[{"id":2143,"href":"https:\/\/denbeke.be\/blog\/wp-json\/wp\/v2\/posts\/2139\/revisions\/2143"}],"wp:attachment":[{"href":"https:\/\/denbeke.be\/blog\/wp-json\/wp\/v2\/media?parent=2139"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/denbeke.be\/blog\/wp-json\/wp\/v2\/categories?post=2139"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/denbeke.be\/blog\/wp-json\/wp\/v2\/tags?post=2139"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}