{"id":14986601,"url":"https://github.com/serversideup/ipaddress-fyi","last_synced_at":"2025-04-11T21:31:29.415Z","repository":{"id":42619941,"uuid":"83064233","full_name":"serversideup/ipaddress-fyi","owner":"serversideup","description":"Easily control access to the Internet’s most popular services","archived":false,"fork":false,"pushed_at":"2022-03-30T20:48:42.000Z","size":790,"stargazers_count":8,"open_issues_count":5,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-25T18:54:02.566Z","etag":null,"topics":["firewall-configuration","laravel-application","open-api","open-data","php-applications","security"],"latest_commit_sha":null,"homepage":"https://ipaddress.fyi","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/serversideup.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-02-24T17:05:22.000Z","updated_at":"2024-08-28T22:33:48.000Z","dependencies_parsed_at":"2022-09-21T21:53:02.484Z","dependency_job_id":null,"html_url":"https://github.com/serversideup/ipaddress-fyi","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serversideup%2Fipaddress-fyi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serversideup%2Fipaddress-fyi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serversideup%2Fipaddress-fyi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serversideup%2Fipaddress-fyi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/serversideup","download_url":"https://codeload.github.com/serversideup/ipaddress-fyi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248482956,"owners_count":21111408,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["firewall-configuration","laravel-application","open-api","open-data","php-applications","security"],"created_at":"2024-09-24T14:13:12.629Z","updated_at":"2025-04-11T21:31:29.041Z","avatar_url":"https://github.com/serversideup.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003ca href=\"https://ipaddress.fyi\"\u003e\u003cimg src=\"https://ipaddress.fyi/img/ipaddress-logo.svg\"\u003e\u003c/a\u003e\u003c/p\u003e\n\n## About this project\n\nThis free service is intended for developers and system administrators to simplify the  management of access control for their own apps and systems. [IPaddress.fyi](https://ipaddress.fyi) organizes network data into a freely accessible JSON formatted data. Developers and system administrators can easily reference the same URL with their application. If the IP Address of a service changes, we'll make the changes for you -- but you won't have to update the references of your application or firewall. The JSON URL will always stay the same!\n\n## How To use\n[IPaddress.fyi](https://ipaddress.fyi) is so easy to use, even your grandmother will know how to use it:\n\n1. Visit [https://ipaddress.fyi](https://ipaddress.fyi)\n2. Select the service(s) of your choice\n3. Click \"Show My Integration URL\"\n4. Copy the link and integrate this data with your application/firewall. Our URL will never change, but we will always keep the information up to date for you.\n\n## Contributing\n\nWe've open sourced the entire code so that we can all work together to make a beautiful and organized set of network data.\n\n### Reporting and issue or inaccuracy\nIf you find a problem, [create an issue](https://github.com/521dimensions/ipaddress-fyi/issues/new).\n\n### Adding a service\nTo add a service, you will need to submit a pull request. To do this, you will need to create a new `.json` file under `/public/services`.\n\nEach service requires:\n\n1. `name`: The name of the service\n2. `category`: How this service should be categorized on the homepage\n3. `source`: A trusted URL where you got this information from\n4. `command`: What Bash command to run in order to make sure the data stays up to date\n5. If you cannot get the information through a command, then `addresses` is required. This should be a list of addresses that are verified to be related to the service. In a perfect world, we will want to use the `command` field to update data as much as possible so that we can guarantee changes can be updated without human interaction.\n\nSee the files under `/public/services` to see the examples that we already have.\n\n## Running your own server\nIf you prefer to run your own server, you will need a working PHP and MySQL environment. This is a Laravel PHP application, so after you clone it to your server of choice, you will need to install the packages using `npm install` and `composer install` from root directory of our repository. You'll need to properly configure your `.env` file and make sure that your application key is properly set within that file.\n\n## Manually updating addresses\nIf you want to update the addresses manually, we created a command to do so:\n```sh\ncd /path/to/the/repo/\nphp artisan update:ipaddresses all\n```\n\n## Automating address updates\nUse `cron` to automate the updates. To do this, run `crontab -e` and then add these lines:\n\n```sh\n# ipaddress.fyi address updates\n* * * * * /usr/bin/php /path/to/the/repo/artisan schedule:run \u003e\u003e /dev/null 2\u003e\u00261\n```\nImportant notes when configuring `cron`:\n- Make sure you configure the correct location to `artisan` by replacing `/pat/to/my/repo` to be the correct location of where you are running the application.\n- The script above will check every minute to see if it should run (using the Laravel Scheduler). But the address update function will only run once per day at 5 AM GMT.\n\n# Special Thanks\nWe've used a lot of cool tools that have helped inspire this project:\n\n- [Ninite.com](https://ninite.com)\n- [icanhazip.com](https://icanhazip.com/)\n- [Digital Ocean](https://digitalocean.com)\n- [Dribbble.com](https://dribbble.com)\n- [MFG Labs](https://mfglabs.github.io/mfglabs-iconset/)\n- [Flat Icon](http://www.flaticon.com/)\n\n# License\n\nIPaddress.fyi's code and data are all open-sourced and made available through the [MIT license](https://raw.githubusercontent.com/521dimensions/ipaddress-fyi/master/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fserversideup%2Fipaddress-fyi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fserversideup%2Fipaddress-fyi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fserversideup%2Fipaddress-fyi/lists"}