mirror of
https://github.com/taigrr/wtf
synced 2025-01-18 04:03:14 -08:00
159 lines
6.5 KiB
HTML
159 lines
6.5 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en-us" class="wf-firasans-n4-active wf-active">
|
|
<head>
|
|
<link href="http://gmpg.org/xfn/11" rel="profile">
|
|
<meta charset="utf-8">
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
|
<!-- Enable responsiveness on mobile devices -->
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1">
|
|
|
|
|
|
<meta name="generator" content="Hugo 0.38.2" />
|
|
|
|
<title>Configuration | WTF</title>
|
|
<meta content="Configuration - WTF" property="og:title">
|
|
<meta content=" - " property="og:description">
|
|
<!-- CSS -->
|
|
<link rel="stylesheet" href="//cdn.rawgit.com/milligram/milligram/master/dist/milligram.min.css">
|
|
<link href="https://fonts.googleapis.com/css?family=Fira+Sans:300,300i,400,400i|Roboto+Mono:300,300i,400,400i" rel="stylesheet">
|
|
<link rel="stylesheet" href="http://wtfutil.com/css/print.css" media="print">
|
|
<link rel="stylesheet" href="http://wtfutil.com/css/poole.css">
|
|
<link rel="stylesheet" href="http://wtfutil.com/css/hyde.css">
|
|
<link rel="stylesheet" href="http://wtfutil.com/css/wtf.css">
|
|
<!-- Font-Awesome -->
|
|
<script defer src="https://use.fontawesome.com/releases/v5.0.9/js/all.js" integrity="sha384-8iPTk2s/jMVj81dnzb/iFR2sdA7u06vHJyyLlAd4snFpCl/SnyUjRrbdJsw1pGIl" crossorigin="anonymous"></script>
|
|
|
|
<!-- Customised CSS -->
|
|
<link rel="stylesheet" href="http://wtfutil.com/css/custom.css">
|
|
<!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
|
|
<!--[if lt IE 9]>
|
|
<script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
|
|
<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
|
|
<![endif]-->
|
|
<!-- Icons -->
|
|
<link rel="apple-touch-icon-precomposed" sizes="144x144" href="/apple-touch-icon-144-precomposed.png">
|
|
<link rel="shortcut icon" href="/favicon.png">
|
|
|
|
<script async defer src="https://buttons.github.io/buttons.js"></script>
|
|
|
|
</head>
|
|
<body>
|
|
<div class="sidebar">
|
|
<div class="container sidebar-sticky">
|
|
<div class="sidebar-about text-center">
|
|
|
|
<a href="http://wtfutil.com/"> <img src="/img/wtf.png" alt="WFT Logo" class="" width=""> </a>
|
|
<p class="lead">
|
|
|
|
</p>
|
|
</div>
|
|
|
|
<div>
|
|
<h3 style="color: white;">Content</h3>
|
|
<ul style="list-style-type: none;">
|
|
<li class="sidebar-list-item-1"><a href="/posts/installation/" class="disabled">Installation</a></li>
|
|
<li class="sidebar-list-item-1"><a href="/posts/configuration/">Configuration</a></li>
|
|
</ul>
|
|
|
|
<ul style="list-style-type: none;">
|
|
<li class="sidebar-list-item-1"><a href="/posts/modules/">Modules</a></li>
|
|
<li class="sidebar-list-item-2"><a href="/posts/modules/bamboohr/">BambooHR</a></li>
|
|
<li class="sidebar-list-item-2"><a href="/posts/modules/clocks/">Clocks</a></li>
|
|
<li class="sidebar-list-item-2"><a href="/posts/modules/git/">Git</a></li>
|
|
<li class="sidebar-list-item-2"><a href="/posts/modules/github/" class="disabled">Github</a></li>
|
|
<li class="sidebar-list-item-2"><a href="/posts/modules/gcal/" class="disabled">Google Calendar</a></li>
|
|
<li class="sidebar-list-item-2"><a href="/posts/modules/jira/" class="disabled">Jira</a></li>
|
|
<li class="sidebar-list-item-2"><a href="/posts/modules/newrelic/">New Relic</a></li>
|
|
<li class="sidebar-list-item-2"><a href="/posts/modules/opsgenie/">OpsGenie</a></li>
|
|
<li class="sidebar-list-item-2"><a href="/posts/modules/security/">Security</a></li>
|
|
<li class="sidebar-list-item-2"><a href="/posts/modules/textfile/">Text File</a></li>
|
|
<li class="sidebar-list-item-2"><a href="/posts/modules/todo/" class="disabled">Todo</a></li>
|
|
<li class="sidebar-list-item-2"><a href="/posts/modules/weather/">Weather</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
<p class="copyright">
|
|
© 2018 Chris Cummer.
|
|
<br />
|
|
<a href="https://creativecommons.org/licenses/by/4.0">Some Rights Reserved</a>.
|
|
</p>
|
|
<p class="copyright">
|
|
Built with <a href="https://gohugo.io/">Hugo</a> & <a href="https://github.com/htr3n/hyde-hyde">hyde-hyde</a>.
|
|
</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="content container">
|
|
<div class="post">
|
|
<h1>Configuration</h1>
|
|
|
|
<div class="col-sm-12 col-md-12">
|
|
<span class="text-left post-date meta">
|
|
|
|
|
|
<i class="fas fa-calendar-alt"></i> Apr 15, 2018
|
|
|
|
|
|
|
|
|
|
<br/>
|
|
<i class="fas fa-clock"></i> 2 min read
|
|
</span>
|
|
</div>
|
|
|
|
|
|
|
|
<h2 id="configuration-files">Configuration Files</h2>
|
|
|
|
<p>By default WTF looks in a <code>~/.wtf/</code> directory for a YAML file called
|
|
<code>config.yml</code>. If the <code>~/.wtf/</code> directory doesn’t exist, WTF will create that directory
|
|
on start-up, and then display instructions for creating a new
|
|
configuration file.</p>
|
|
|
|
<p>In other words, WTF expects to have a YAML config file at: <code>~/.wtf/config.yml</code>.</p>
|
|
|
|
<h4 id="example-configuration-files">Example Configuration Files</h4>
|
|
|
|
<p>A couple of example config files are provided in the <code>_sample_configs/</code>
|
|
directory of the Git repository.</p>
|
|
|
|
<p>To try out WTF quickly, copy
|
|
<code>simple_config.yml</code> into <code>~/.wtf/</code> as <code>config.yml</code> and relaunch WTF. You
|
|
should see the app launch and display the <a href="/posts/modules/security/">Security</a>,
|
|
<a href="/posts/modules/clocks/">Clocks</a> and <a href="/posts/modules/status/">Status</a> widgets onscreen.</p>
|
|
|
|
<h4 id="custom-configuration-files">Custom Configuration Files</h4>
|
|
|
|
<p>To try out different configurations (or run multiple instances of WTF),
|
|
you can pass the path to a config file via command line arguments on
|
|
start-up.</p>
|
|
|
|
<p>To load a custom configuration file (ie: one that’s not
|
|
<code>~/.wtf/config.yml</code>), pass in the path to configuration file as a
|
|
parameter on launch:</p>
|
|
|
|
<pre><code class="language-bash"> $> wtf --config=path/to/custom/config.yml
|
|
</code></pre>
|
|
|
|
<h2 id="environment-env-variables">Environment (ENV) Variables</h2>
|
|
|
|
<p>Some modules require the presence of environment variables to function
|
|
properly. Usually these are API keys or other sensitive data that one
|
|
wouldn’t want to have laying about in the config files.</p>
|
|
|
|
<p>For modules that require them, the name of the required environment
|
|
variable(s) can be found in that module’s “Required ENV Variables”
|
|
section of the documentation. See <a href="/posts/modules/opsgenie/">OpsGenie</a> for an example.</p>
|
|
|
|
</div>
|
|
<div class="footer">
|
|
|
|
|
|
|
|
</div>
|
|
</div>
|
|
|
|
|
|
</body>
|
|
</html>
|